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1. INTRODUCTION. 

This manual describes CP/M, release 2, system organization 
including the structure of memory and system entry points. The 
intention is to provide the necessary information required to write 
programs which operate under CP/M, and which use the peripheral and 
disk I/O facilities of the system. 

CP/M is logically divided into four parts, called the Basic I/O 
System (BIOS) , the Basic Disk Operating System (BDOS) , the Console 
command processor (CCP) , and the Transient Program Area (TPA) . The 
BIOS is a hardware-dependent module which defines the exact low level 
interface to a particular computer system which is necessary for 
peripheral device I/O. Although a standard BIOS is supplied by 
Digital Research, explicit instructions are provided for field 
reconfiguration of the BIOS to match nearly any hardware environment 
(see the Digital Research manual entitled "CP/M Alteration Guide") . 
The BIOS and BDOS are logically combined into a single module with a 
common entry point, and referred to as the FDOS. The CCP is a 
distinct program which uses the FDOS to provide a human-oriented 
interface to the information which is cataloged on the backup storage 
device. The TPA is an area of memory (i.e., the portion which is not 
used by the FDOS and CCP) where various non-resident operating system 
commands and user programs are executed. The lower portion of memory 
is reserved for system information and is detailed later sections. 
Memory organization of the CP/M system in shown below: 



high 
memory 

FBASE: 



CBASE: 



TBASE: 



BOOT: 



1 FDOS 


(BDOS+BIOS) | 


1 CCP 1 


I TPA | 


1 system parameters | 



The exact memory addresses corresponding to BOOT, TBASE, CBASE, and 
FBASE vary from version to version, and are described fully in the 
"CP/M Alteration Guide." All standard CP/M versions, however, assume 
BOOT = 0000H, which is the base of random access memory. The machine 
code found at location BOOT performs a system "warm start" which loads 
and initializes the programs and variables necessary to return control 
to the CCP. Thus, transient programs need only jump to location BOOT 
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to return control to CP/M at the command level. Further, the standard 
versions assume TBASE = BOOT+0100H which is normally location 0100H. 
The principal entry point to the FDOS is at location BOOT+0005H 
(normally 0005H) where a jump to FBASE is found. The address field at 
BOOT+0006H (normally 0006H) contains the value of FBASE and can be 
used to determine the size of available memory, assuming the CCP is 
being overlayed by a transient program. 

Transient programs are loaded into the TPA and executed as 
follows. The operator communicates with the CCP by typing command 
lines following each prompt. Each command line takes one of the 
forms : 

command 
command filel 
command filel file2 

where "command" is either a built-in function such as DIR or TYPE, or 
the name of a transient command or program. If the command is a 
built-in function of CP/M, it is executed immediately. Otherwise, the 
CCP searches the currently addressed disk for a file by the name 

command.COM 

If the file is found, it is assumed to be a memory image of a program 
which executes in the TPA, and thus implicitly originates at TBASE in 
memory. The CCP loads the COM file from the disk into memory starting 
at TBASE and possibly extending up to CBASE. 

If the command is followed by one or two file specifications, 
the CCP prepares one or two file control block (FCB) names in the 
system parameter area. These optional FCB's are in the form necessary 
to access files through the FDOS, and are described in the next 
section. 

The transient program receives control from the CCP and begins 
execution, perhaps using the I/O facilities of the FDOS. The 
transient program is "called 11 from the CCP, and thus can simply return 
to the CCP upon completion of its processing, or can jump to BOOT to 
pass control back to CP/M. In the first case, the transient program 
must not use memory above CBASE, while in the latter case, memory up 
through FBASE-1 is free. 

The transient program may use the CP/M I/O facilities to 
communicate with the operator's console and peripheral devices, 
including the disk subsystem. The I/O system is accessed by passing a 
"function number" and an "information address" to CP/M through the 
FDOS entry point at BOOT+0005H. In the case of a disk read, for 
example, the transient program sends the number corresponding to a 
disk read, along with the address of an FCB to the CP/M FDOS. The 
FDOS, in turn, performs the operation and returns with either a disk 
read completion indication or an error number indicating that the disk 
read was unsuccessful. The function numbers and error indicators are 
given in below. 
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2. OPERATING SYSTEM CALL CONVENTIONS. 

The purpose of this section is to provide detailed information 
for performing direct operating system calls from user programs. Many 
of the functions listed below, however, are more simply accessed 
through the I/O macro library provided with the MAC macro assembler, 
and listed in the Digital Research manual entitled "MAC Macro 
Assembler: Language Manual and Applications Guide." 

CP/M facilities which are available for access by transient 
programs fall into two general categories: simple device I/O, and 
disk file I/O. The simple device operations include: 

Read a Console Character 

Write a Console Character 

Read a Sequential Tape Character 

Write a Sequential Tape Character 

Write a List Device Character 

Get or Set I/O Status 

Print Console Buffer 

Read Console Buffer 

Interrogate Console Ready 

The FDOS operations which perform disk Input/Output are 

Disk System Reset 

Drive Selection 

File Creation 

File Open 

File Close 

Directory Search 

File Delete 

File Rename 

Random or Sequential Read 

Random or Sequential Write 

Interrogate Available Disks 

Interrogate Selected Disk 

Set DMA Address 

Set/Reset File Indicators 

As mentioned above, access to the FDOS functions is accomplished 
by passing a function number and information address through the 
primary entry point at location BOOT+0005H. In general, the function 
number is passed in register C with the information address in the 
double byte pair DE. Single byte values are returned in register A, 
with double byte values returned in HL (a zero value is returned when 
the function number is out of range). For reasons of compatibility, 
register A = L and register B = H upon return in all cases. Note that 
the register passing conventions of CP/M agree with those of Intel's 
PL/M systems programming language. The list of CP/M function numbers 
is given below. 
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System Reset 

1 Console Input 

2 Console Output 

3 Reader Input 

4 Punch Output 

5 List Output 

6 Direct Console I/O 

7 Get I/O Byte 

8 Set I/O Byte 

9 Print String 

10 Read Console Buffer 

11 Get Console Status 

12 Return Version Number 

13 Reset Disk System 

14 Select Disk 

15 Open File 

16 Close File 

17 Search for First 

18 Search for Next 



19 Delete File 

20 Read Sequential 

21 Write Sequential 

22 Make File 

23 Rename File 

24 Return Login Vector 

25 Return Current Disk 

26 Set DMA Address 

27 Get Addr(Alloc) 

28 Write Protect Disk 

29 Get R/O Vector 

30 Set File Attributes 

31 Get Addr(Disk Parms) 

32 Set/Get User Code 

33 Read Random 

34 Write Random 

35 Compute File Size 

36 Set Random Record 



(Functions 28 and 32 should be avoided in 
maintain upward compatibility with MP/M.) 
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BDOS 


EQU 


0005H 


CONIN 


EQU 


1 


/ 


ORG 


0100H 


NEXTC: 


MVI 


C, CONIN 




CALL 


BDOS 




CPI 


• * • 




JNZ 


NEXTC 




RET 






END 





; STANDARD CP/M ENTRY 
;CONSOLE INPUT FUNCTION 

BASE OF TPA 

READ NEXT CHARACTER 

RETURN CHARACTER IN <A> 

END OF PROCESSING? 

LOOP IF NOT 

RETURN TO CCP 



CP/M implements a named file structure on each disk, providing a 
logical organization which allows any particular file to contain any 
number of records from completely empty, to the full capacity of the 
drive. Each drive is logically distinct with a disk directory and 
file data area. The disk file names are in three parts: the drive 
select code, the file name consisting of one to eight non-blank 
characters, and the file type consisting of zero to three non-blank 
characters. The file type names the generic category of a particular 
file, while the file name distinguishes individual files in each 
category. The file types listed below name a few generic categories 
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which have been established, although they are generally arbitrary: 

ASM Assembler Source PLI PL/I Source File 

PRN Printer Listing REL Relocatable Module 

HEX Hex Machine Code TEX TEX Formatter Source 

BAS Basic Source File BAK ED Source Backup 

INT Intermediate Code SYM SID Symbol File 

COM CCP Command File $$$ Temporary File 

Source files are treated as a sequence of ASCII characters, where each 
"line" of the source file is followed by a carriage-return line-feed 
sequence (0DH followed by 0AH) . Thus one 128 byte CP/M record could 
contain several lines of source text. The end of an ASCII file is 
denoted by a control-Z character (1AH) or a real end of file, returned 
by the CP/M read operation. Control-Z characters embedded within 
machine code files (e.g., COM files) are ignored, however, and the end 
of file condition returned by CP/M is used to terminate read 
operations. 

Files in CP/M can be thought of as a sequence of up to 65536 
records of 128 bytes each, numbered from through 65535, thus 
allowing a maximum of 8 megabytes per file. Note, however, that 
although the records may be considered logically contiguous, they may 
not be physically contiguous in the disk data area. Internally, all 
files are broken into 16K byte segments called logical extents, so 
that counters are easily maintained as 8-bit values. Although the 
decomposition into extents is discussed in the paragraphs which 
follow, they are of no particular consequence to the programmer since 
each extent is automatically accessed in both sequential and random 
access modes. 

In the file operations starting with function number 15, DE 
usually addresses a file control block (FCB) . Transient programs 
often use the default file control block area reserved by CP/M at 
location BOOT+005CH (normally 005CH) for simple file operations. The 
basic unit of file information is a 128 byte record used for all file 
operations, thus a default location for disk I/O is provided by CP/M 
at location BOOT+0080H (normally 0080H) which is the initial default 
DMA address (see function 26) . All directory operations take place in 
a reserved area which does not affect write buffers as was the case in 
release 1, with the exception of Search First and Search Next, where 
compatibility is required. 

The File Control Block (FCB) data area consists of a sequence of 
33 bytes for sequential access and a series of 36 bytes in the case 
that the file is accessed randomly. The default file control block 
normally located at 005CH can be used for random access files, since 
the three bytes starting at BOOT+007DH are available for this purpose. 
The FCB format is shown with the following fields: 
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|dr|fl|f2|/ / I f 8 I tl 1 12 1 13 I ex | si I s2 I r c I d0 I / / |dn |cr I r0 I rl I r2 I 
00 01 02 ... 08 09 10 11 12 13 14 15 16 ... 31 32 33 34 35 
where 

dr drive code (0 - 16) 

=> use default drive for file 

1 => auto disk select drive A, 

2 => auto disk select drive B, 
• • . 

16=> auto disk select drive P. 

fl...f8 contain the file name in ASCII 
upper case, with high bit = 

tl,t2,t3 contain the file type in ASCII 
upper case, with high bit = 
tl 1 , t2', and t3' denote the 
bit of these positions, 
tl' = 1 => Read/Only file, 
t2' = 1 => SYS file, no DIR list 

ex contains the current extent number, 
normally set to 00 by the user, but 
in range 0-31 during file I/O 

si reserved for internal system use 

s2 reserved for internal system use, set 
to zero on call to OPEN, MAKE, SEARCH 

re record count for extent "ex," 
takes on values from - 128 

d0...dn filled-in by CP/M, reserved for 
system use 

cr current record to read or write in 

a sequential file operation, normally 
set to zero by user 

r0,rl,r2 optional random record number in the 
range 0-65535, with overflow to r2, 
r0,rl constitute a 16-bit value with 
low byte r0, and high byte rl 

Each file being accessed through CP/M must have a corresponding 
FCB which provides the name and allocation information for all 
subsequent file operations. When accessing files, it is the 
programmer's responsibility to fill the lower sixteen bytes of the FCB 
and initialize the "cr" field. Normally, bytes 1 through 11 are set 
to the ASCII character values for the file name and file type, while 
all other fields are zero. 
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FCB's are stored in a directory area of the disk, and are 
brought into central memory before proceeding with file operations 
(see the OPEN and MAKE functions) . The memory copy of the FCB is 
updated as file operations take place and later recorded permanently 
on disk at the termination of the file operation (see the CLOSE 
command) . 

The CCP constructs the first sixteen bytes of two optional FCB's 
for a transient by scanning the remainder of the line following the 
transient name, denoted by "filel" and "file2" in the prototype 
command line described above, with unspecified fields set to ASCII 
blanks. The first FCB is constructed at location BOOT+005CH, and can 
be used as-is for subsequent file operations. The second FCB occupies 
the d0 ... dn portion of the first FCB, and must be moved to another 
area of memory before use. If, for example, the operator types 

PROGNAME B:X.ZOT Y.ZAP 

the file PROGNAME.COM is loaded into the TPA, and the default FCB at 
BOOT+005CH is initialized to drive code 2, file name "X" and file type 
"ZOT". The second drive code takes the default value 0, which is 
placed at BOOT+006CH, with the file name M Y h placed into location 
BOOT+006DH and file type "ZAP" located 8 bytes later at BOOT+0075H. 
All remaining fields through "cr" are set to zero. Note again that it 
is the programmer's responsibility to move this second file name and 
type to another area, usually a separate file control block, before 
opening the file which begins at BOOT+005CH, due to the fact that the 
open operation will overwrite the second name and type. 

If no file names are specified in the original command, then the 
fields beginning at BOOT+005DH and BOOT+006DH contain blanks. In all 
cases, the CCP translates lower case alphabetics to upper case to be 
consistent with the CP/M file naming conventions. 

As an added convenience, the default buffer area at location 
BOOT+0080H is initialized to the command line tail typed by the 
operator following the program name. The first position contains the 
number of characters, with the characters themselves following the 
character count. Given the above command line, the area beginning at 
BOOT+0080K is initialized as follows: 

BOOT+0 8 0H: 

+00 +01 +02 +03 +04 +05 +06 +07 +08 +09 +10 +11 +12 +13 +14 

~\ A •• ■■ •* D " M • " " Y " M M " 7 " " O " " T* " " *' " V '' '* '* " 7 " "A " *• "D *' 

where the characters are translated to upper case ASCII with 
uninitialized memory following the last valid character. Again, it is 
the responsibility of the programmer to extract the information from 
this buffer before any file operations are performed, unless the 
default DMA address is explicitly changed. 

The individual functions are described in detail in the pages 
which follow. 
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*************************************** 

* * 

* FUNCTION 0: System Reset * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 00H * 
*************************************** 



The system reset function returns control to the CP/M operating 
system at the CCP level. The CCP re-initializes the disk subsystem by 
selecting and logging-in disk drive A. This function has exactly the 
same effect as a jump to location BOOT. 

*************************************** 

* * 

* FUNCTION 1: CONSOLE INPUT * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 01H * 

* * 

* Returned Value : * 

* Register A: ASCII Character * 

*************************************** 

The console input function reads the next console character to 
register A. Graphic characters, along with carriage return, line 
feed, and backspace (ctl-H) are echoed to the console. Tab characters 
(ctl-I) are expanded in columns of eight characters. A check is made 
for start/stop scroll (ctl-S) and start/stop printer echo (ctl-P) . 
The FDOS does not return to the calling program until a character has 
been typed, thus suspending execution if a character is not ready. 

*************************************** 

* * 

* FUNCTION 2: CONSOLE OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 02H * 

* Register E: ASCII Character * 

* * 

*************************************** 

The ASCII character from register E is sent to the console 
device. Similar to function 1, tabs are expanded and checks are made 
for start/stop scroll and printer echo. 
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*************************************** 

* * 

* FUNCTION 3: READER INPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 03H * 

* * 

* Returned Value: * 

* Register A: ASCII Character * 
*************************************** 

The Reader Input function reads the next character from the 
logical reader into register A (see the IOBYTE definition in the "CP/M 
Alteration Guide"). Control does not return until the character has 
been read. 

*************************************** 

* * 

* FUNCTION 4: PUNCH OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 04H * 

* Register E: ASCII Character * 

* * 

*************************************** 

The Punch Output function sends the character from register E to 
the logical punch device. 

*************************************** 

* * 

* FUNCTION 5: LIST OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 05H * 

* Register E: ASCII Character * 

* * 

*************************************** 

The List Output function sends the ASCII character in register E 
to the logical listing device. 
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*************************************** 

* * 

* FUNCTION 6: DIRECT CONSOLE I/O * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 06H * 

* Register E: 0FFH (input) or * 

* char (output) * 

* * 

* Returned Value: * 

* Register A: char or status * 

(no value) * 

*************************************** 

Direct console I/O is supported under CP/M for those specialized 
applications where unadorned console input and output is required. 
Use of this function should, in general, be avoided since it bypasses 
all of CP/M's normal control character functions (e.g., control-S and 
control-P) , Programs which perform direct I/O through the BIOS under 
previous releases of CP/M, however, should be changed to use direct 
I/O under BDOS so that they can be fully supported under future 
releases of MP/M and CP/M. 

Upon entry to function 6, register E either contains hexadecimal 
FF, denoting a console input request, or register E contains an ASCII 
character. If the input value is FF, then function 6 returns A = 00 
if no character is ready, otherwise A contains the next console input 
character. 

If the input value in E is not FF, then function 6 assumes that 
E contains a valid ASCII character which is sent to the console. 
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*************************************** 

* * 

* FUNCTION 7: GET I/O BYTE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 07H * 

* * 

* Returned Value: * 

* Register A: I/O Byte Value * 
*************************************** 



The Get I/O Byte function returns the current value of IOBYTE in 
register A. See the "CP/M Alteration Guide" for IOBYTE definition. 



*************************************** 

* * 

* FUNCTION 8: SET I/O BYTE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 08H * 

* Register E: I/O Byte Value * 

* * 

*************************************** 



The Set I/O Byte function changes the system IOBYTE value to 
that given in register E. 



*************************************** 

* * 

* FUNCTION 9: PRINT STRING * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 09H * 

Registers DE: String Address * 

* * 
*************************************** 



The Print String function sends the character string stored in 

memory at the location given by DE to the console device, until a "$" 

is encountered in the string. Tabs are expanded as in function 2, and 
checks are made for start/stop scroll and printer echo. 
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*************************************** 

* * 

* FUNCTION 10: READ CONSOLE BUFFER * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0AH * 

* Registers DE: Buffer Address * 

* * 

* Returned Value: * 

* Console Characters in Buffer * 
*************************************** 

The Read Buffer function reads a line of edited console input 
into a buffer addressed by registers DE. Console input is terminated 
when either the input buffer overflows. The Read Buffer takes the 
form: 

DE: +0 +1 + 2 +3 +4 +5 +6+7+8 ... +n 

Imx|nc|cl|c2|c3|c4|c5|c6|c7| . . . |??| 



where "mx" is the maximum number of characters which the buffer will 
hold (1 to 255) , "nc h is the number of characters read (set by FDOS 
upon return) , followed by the characters read from the console. if nc 
< mx, then uninitialized positions follow the last character, denoted 
by ••??•• i n the above figure. A number of control functions are 
recognized during line editing: 

rub/del removes and echoes the last character 

ctl-C reboots when at the beginning of line 

ctl-E causes physical end of line 

ctl-H backspaces one character position 

ctl-J (line feed) terminates input line 

ctl-M (return) terminates input line 

ctl-R retypes the current line after new line 

ctl-u removes currnt line after new line 

ctl-x backspaces to beginning of current line 

Note also that certain functions which return the carriage to the 
leftmost position (e.g., ctl-X) do so only to the column position 
where the prompt ended (in earlier releases, the carriage returned to 
the extreme left margin). This convention makes operator data input 
and line correction more legible. 
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*************************************** 

* * 

* FUNCTION 11: GET CONSOLE STATUS * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 0BH * 

* * 

* Returned Value: * 

* Register A: Console Status * 
*************************************** 

The Console Status function checks to see if a character has 
been typed at the console. If a character is ready, the value 0FFH is 
returned in register A. Otherwise a 00H value is returned. 

*************************************** 

* * 

* FUNCTION 12: RETURN VERSION NUMBER * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0CH * 

* * 

* Returned Value: * 

* Registers HL: Version Number * 
*************************************** 

Function 12 provides information which allows version 
independent programming. A two-byte value is returned, with H = 00 
designating the CP/M release (H = 01 for MP/M) , and L = 00 for all 
releases previous to 2.0. CP/M 2.0 returns a hexadecimal 20 in 
register L, with subsequent version 2 releases in the hexadecimal 
range 21, 22, through 2F. Using function 12, for example, you can 
write application programs which provide both sequential and random 
access functions, with random access disabled when operating under 
early releases of CP/M. 
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*************************************** 

* * 

* FUNCTION 13: RESET DISK SYSTEM * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 0DH * 

* * 

*************************************** 

The Reset Disk Function is used to p rogr aroma tically restore the 
file system to a reset state where all disks are set to read/write 
(see functions 28 and 29) , only disk drive A is selected, and the 
default DMA address is reset to BOOT+0080H. This function can be 
used, for example, by an application program which requires a disk 
change without a system reboot. 



*************************************** 

* * 

* FUNCTION 14: SELECT DISK * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0EH * 

* Register E: Selected Disk * 

* * 

*************************************** 

The Select Disk function designates the disk drive named in 
register E as the default disk for subsequent file operations, with E 
= for drive A, 1 for drive B, and so-forth through 15 corresponding 
to drive P in a full sixteen drive system. The drive is placed in an 
"on-line" status which, in particular, activates its directory until 
the next cold start, warm start, or disk system reset operation. If 
the disk media is changed while it is on-line, the drive automatically 
goes to a read/only status in a standard CP/M environment (see 
function 28). FCB's which specify drive code zero (dr = 00H) 
automatically reference the currently selected default drive. Drive 
code values between 1 and 16, however, ignore the selected default 
drive and directly reference drives A through P. 
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*************************************** 

* * 

* FUNCTION 15: OPEN FILE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0FH * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Open File operation is used to activate a file which 
currently exists in the disk directory for the currently active user 
number. The FDOS scans the referenced disk directory for a match in 
positions 1 through 14 of the FCB referenced by DE (byte si is 
automatically zeroed) , where an ASCII question mark (3FH) matches any 
directory character in any of these positions. Normally, no question 
marks are included and, further, bytes "ex" and H s2 11 of the FCB are 
zero. 

If a directory element is matched, the relevant directory 
information is copied into bytes d0 through dn of the FCB, thus 
allowing access to the files through subsequent read and write 
operations. Note that an existing file must not be accessed until a 
sucessful open operation is completed. Upon return, the open function 
returns a "directory code" with the value through 3 if the open was 
successful, or 0FFH (255 decimal) if the file cannot be found. If 
question marks occur in the FCB then the first matching FCB is 
activated. Note that the current record ("cr") must be zeroed by the 
program if the file is to be accessed sequentially from the first 
record. 
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*************************************** 

* * 

* FUNCTION 16: CLOSE FILE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 10H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Close File function performs the inverse of the open file 
function. Given that the FCB addressed by DE has been previously 
activated through an open or make function (see functions 15 and 22) , 
the close function permanently records the new FCB in the referenced 
disk directory. The FCB matching process for the close is identical 
to the open function. The directory code returned for a successful 
close operation is 0, 1, 2, or 3, while a 0FFH (255 decimal) is 
returned if the file name cannot be found in the directory. A file 
need not be closed if only read operations have taken place. If write 
operations have occurred, however, the close operation is necessary to 
permanently record the new directory information. 
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*************************************** 

* * 

* FUNCTION 17: SEARCH FOR FIRST * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 11H * 

* Registers DE: FCB Address * 

* * 

* Returned Value : * 

* Register A: Directory Code * 
*************************************** 

Search First scans the directory for a match with the file given 
by the FCB addressed by DE. The value 255 (hexadecimal FF) is 
returned if the file is not found, otherwise 0, 1, 2, or 3 is returned 
indicating the file is present. In the case that the file is found, 
the current DMA address is filled with the record containing the 
directory entry, and the relative starting position is A * 32 (i.e., 
rotate the A register left 5 bits, or ADD A five times) . Although not 
normally required for application programs, the directory information 
can be extracted from the buffer at this position. 

An ASCII question mark (63 decimal, 3F hexadecimal) in any 
position from "fl" through "ex" matches the corresponding field of any 
directory entry on the default or auto-selected disk drive. If the 
"dr" field contains an ASCII question mark, then the auto disk select 
function is disabled, the default disk is searched, with the search 
function returning any matched entry, allocated or free, belonging to 
any user number. This latter function is not normally used by 
application programs, but does allow complete flexibility to scan all 
current directory values. If the "dr" field is not a question mark, 
the "s2" byte is automatically zeroed. 



*************************************** 

* * 

* FUNCTION 18: SEARCH FOR NEXT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 12H * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 



The Search Next function is similar to the Search First 
function, except that the directory scan continues from the last 
matched entry. Similar to function 17, function 18 returns the 
decimal value 255 in A when no more directory items match. 
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*************************************** 

* * 

* FUNCTION 19: DELETE FILE * 



* 



* 



*************************************** 

* Entry Parameters: * 

* Register C: 13H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Delete File function removes files which match the FCB 
addressed by DE. The filename and type may contain ambiguous 
references (i.e., question marks in various positions), but the drive 
select code cannot be ambiguous, as in the Search and Search Next 
functions. 

Function 19 returns a decimal 255 if the referenced file or 
files cannot be found, otherwise a value in the range to 3 is 
returned. 



*************************************** 

* * 

* FUNCTION 20: READ SEQUENTIAL * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 14H * 

* Registers DE: FCB Address * 

* * 

* Returned Value : * 

* Register A: Directory Code * 
*************************************** 

Given that the FCB addressed by DE has been activated through an 
open or make function (numbers 15 and 22) , the Read Sequential 
function reads the next 128 byte record from the file into memory at 
the current DMA address. the record is read from position "cr" of the 
extent, and the "cr" field is automatically incremented to the next 
record position. If the "cr" field overflows then the next logical 
extent is automatically opened and the "cr" field is reset to zero in 
preparation for the next read operation. The value 00H is returned in 
the A register if the read operation was successful, while a non-zero 
value is returned if no data exists at the next record position (e.g. , 
end of file occurs). 
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*************************************** 

* * 

* FUNCTION 21: WRITE SEQUENTIAL * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 15H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

Given that the FCb addressed by DE has been activated through an 
open or make function (numbers 15 and 22), the Write Sequential 
function writes the 128 byte data record at the current DMA address to 
the file named by the FCB. the record is placed at position "cr" of 
the file, and the "cr" field is automatically incremented to the next 
record position. If the "cr" field overflows then the next logical 
extent is automatically opened and the "cr 11 field is reset to zero in 
preparation for the next write operation. Write operations can take 
place into an existing file, in which case newly written records 
overlay those which already exist in the file. Register A = 00H upon 
return from a successful write operation, while a non-zero value 
indicates an unsuccessful write due to a full disk. 



*************************************** 

* * 

* FUNCTION 22: MAKE FILE * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 16H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Make File operation is similar to the open file operation 
except that the FCB must name a file which does not exist in the 
currently referenced disk directory (i.e., the one named explicitly by 
a non-zero "dr" code, or the default disk if "dr" is zero) . The FDOS 
creates the file and initializes both the directory and main memory 
value to an empty file. The programmer must ensure that no duplicate 
file names occur, and a preceding delete operation is sufficient if 
there is any possibility of duplication. Upon return, register A = 0, 
1, 2, or 3 if the operation was successful and 0FFH (255 decimal) if 
no more directory space is available. The make function has the 
side-effect of activating the FCB and thus a subsequent open is not 
necessary. 
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*************************************** 

* * 

* FUNCTION 23: RENAME FILE * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 17H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Rename function uses the FCB addressed by DE to change all 
occurrences of the file named in the first 16 bytes to the file named 
in the second 16 bytes. The drive code "dr" at position is used to 
select the drive, while the drive code for the new file name at 
position 16 of the FCB is assumed to be zero. Upon return, register A 
is set to a value between and 3 if the rename was successful, and 
0FFH (255 decimal) if the first file name could not be found in the 
directory scan. 



*************************************** 

* * 

* FUNCTION 24: RETURN LOGIN VECTOR * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 18H * 

* * 

* Returned Value: * 

* Registers HL: Loqin Vector * 
*************************************** 

The login vector value returned by CP/M is a 16-bit value in HL, 
where the least significant bit of L corresponds to the first drive A, 
and the high order bit of H corresponds to the sixteenth drive, 
labelled P. A M 0" bit indicates that the drive is not on-line, while 
a "1" bit marks an drive that is actively on-line due to an explicit 
disk drive selection, or an implicit drive select caused by a file 
operation which specified a non-zero "dr M field. Note that 
compatibility is maintained with earlier releases, since registers A 
and L contain the same values upon return. 



(All Information Contained Herein is Proprietary to Digital Research.) 

20 



*************************************** 

* * 

* FUNCTION 25: RETURN CURRENT DISK * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 19H * 

* * 

* Returned Value : * 

* Register A: Current Disk * 
*************************************** 



Function 25 returns the currently selected default disk number 
in register A. The disk numbers range from through 15 corresponding 
to drives A through P. 



*************************************** 

* * 

* FUNCTION 26: SET DMA ADDRESS * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1AH * 

* Registers DE: DMA Address * 

* * 
*************************************** 

"DMA" is an acronym for Direct Memory Address, which is often 
used in connection with disk controllers which directly access the 
memory of the mainframe computer to transfer data to and from the disk 
subsystem. Although many computer systems use non-DMA access (i.e., 
the data is transfered through programmed I/O operations) , the DMA 
address has, in CP/M, come to mean the address at which the 128 byte 
data record resides before a disk write and after a disk read. Upon 
cold start, warm start, or disk system reset, the DMA address is 
automatically set to BOOT+0080H. The Set DMA function, however, can 
be used to change this default value to address another area of memory 
where the data records reside. Thus, the DMA address becomes the 
value specified by DE until it is changed by a subsequent Set DMA 
function, cold start, warm start, or disk system reset. 
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*************************************** 

* * 

* FUNCTION 27: GET ADDR (ALLOC) * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1BH * 

* * 

* Returned Value : * 

* Registers HL: ALLOC Address * 
*************************************** 

An "allocation vector" is maintained in main memory for each 
on-line disk drive. Various system programs use the information 
provided by the allocation vector to determine the amount of remaining 
storage (see the STAT program) . Function 27 returns the base address 
of the allocation vector for the currently selected disk drive. The 
allocation information may, however, be invalid if the selected disk 
has been marked read/only. Although this function is not normally 
used by application programs, additional details of the allocation 
vector are found in the "CP/M Alteration Guide." 



*************************************** 

* * 

* FUNCTION 28: WRITE PROTECT DISK * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1CH * 

* * 

*************************************** 

The disk write protect function provides temporary write 

protection for the currently selected disk. Any attempt to write to 

the disk, before the next cold or warm start operation produces the 
message 

Bdos Err on d: R/O 
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*************************************** 

* * 

* FUNCTION 29: GET READ/ONLY VECTOR * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1DH * 

* * 

* Returned Value : * 

* Registers HL: R/O Vector Value* 
*************************************** 

Function 29 returns a bit vector in register pair HL which 
indicates drives which have the temporary read/only bit set. Similar 
to function 24, the least significant bit corresponds to drive A, 
while the most significant bit corresponds to drive P. The R/0 bit is 
set either by an explicit call to function 28, or by the automatic 
software mechanisms within CP/M which detect changed disks. 



*************************************** 

* * 

* FUNCTION 30: SET FILE ATTRIBUTES * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1EH * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Set File Attributes function allows programmatic 
manipulation of permanent indicators attached to files. In 
particular, the R/0 and System attributes (tl 1 and t2') can be set or 
reset. The DE pair addresses an unambiguous file name with the 
appropriate attributes set or reset. Function 30 searches for a 
match, and changes the matched directory entry to contain the selected 
indicators. Indicators fl' through f4' are not presently used, but 
may be useful for applications programs, since they are not involved 
in the matching process during file open and close operations. 
Indicators f5' through f8' and t3' are reserved for future system 
expansion. 
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*************************************** 

* * 

* FUNCTION 31: GET ADDR(DISK PARMS) * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1FH * 

* * 

* Returned Value: * 

* Registers HL: DPB Address * 
*************************************** 



The address of the BIOS resident disk parameter block is 
returned in HL as a result of this function call. This address can be 
used for either of two purposes. First, the disk parameter values can 
be extracted for display and space computation purposes, or transient 
programs can dynamically change the values of current disk parameters 
when the disk environment changes, if required. Normally, application 
programs will not require this facility. 



*************************************** 

* * 

* FUNCTION 3 2: SET/GET USER CODE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 20H * 

* Register E: 0FFH (get) or * 

* User Code (set) * 

* * 

* Returned Value: * 

* Register A: Current Code or * 

* (no value) * 
*************************************** 



An application program can change or interrogate the currently 
active user number by calling function 32. If register E = 0FFH, then 
the value of the current user number is returned in register A, where 
the value is in the range to 31. If register E is not 0FFH, then 
the current user number is changed to the value of E (modulo 32). 
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*************************************** 

* * 

* FUNCTION 33: READ RANDOM * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 21H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Return Code 

*************************************** 




Thus, the r0,rl byte pair is treated as a double-byte, or "word" 
value, which contains the record to read. This value ranges from to 
65535, providing access to any particular record of the 8 megabyte 
file. In order to process a file using random access, the base extent 
(extent 0) must first be opened. Although the base extent may or may 
not contain any allocated data, this ensures that the file is properly 
recorded in the directory, and is visible in DIR requests. The 
selected record number is then stored into the random record field 
(r0,rl), and the BDOS is called to read the record. Upon return from 
the call, register A either contains an error code, as listed below, 
or the value 00 indicating the operation was successful. In the 
latter case, the current DMA address contains the randomly accessed 
record. Note that contrary to the sequential read operation, the 
record number is not advanced. Thus, subsequent random read 
operations continue to read the same record. 

Upon each random read operation, the logical extent and current 
record values are automatically set. Thus, the file can be 
sequentially read or written, starting from the current randomly 
accessed position. Note, however, that in this case, the last 
randomly read record will be re-read as you switch from random mode to 
sequential read, and the last record will be re-written as you switch 
to a sequential write operation. You can, of course, simply advance 
the random record position following each random read or write to 
obtain the effect of a sequential I/O operation. 

Error codes returned in register A following a random read are 
listed below. 
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01 reading unwritten data 

02 (not returned in random mode) 

03 cannot close current extent 

04 seek to unwritten extent 

05 (not returned in read mode) 

06 seek past physical end of disk 

Error code 01 and 04 occur when a random read operation accesses a 
data block which has not been previously written, or an extent which 
has not been created, which are equivalent conditions. Error 3 does 
not normally occur under proper system operation, but can be cleared 
by simply re-reading, or re-opening extent zero as long as the disk is 
not physically write protected. Error code 06 occurs whenever byte r2 
is non-zero under the current 2.0 release. Normally, non-zero return 
codes can be treated as missing data, with zero return codes 
indicating operation complete. 
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*************************************** 

* * 

* FUNCTION 34: WRITE RANDOM * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 22H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Return Code * 
*************************************** 

The Write Random operation is initiated similar to the Read 
Random call, except that data is written to the disk from the current 
DMA address. Further, if the disk extent or data block which is the 
target of the write has not yet been allocated, the allocation is 
performed before the write operation continues. As in the Read Random 
operation, the random record number is not changed as a result of the 
write. The logical extent number and current record positions of the 
file control block are set to correspond to the random record which is 
being written. Again, sequential read or write operations can 
commence following a random write, with the notation that the 
currently addressed record is either read or rewritten again as the 
sequential operation begins. You can also simply advance the random 
record position following each write to get the effect of a sequential 
write operation. Note that in particular, reading or writing the last 
record of an extent in random mode does not cause an automatic extent 
switch as it does in sequential mode. 

The error codes returned by a random write are identical to the 
random read operation with the addition of error code 05, which 
indicates that a new extent cannot be created due to directory 
overflow. 
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*************************************** 

* * 

* FUNCTION 35: COMPUTE FILE SIZE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 23H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Random Record Field Set * 
*************************************** 

When computing the size of a file, the DE register pair 
addresses an FCB in random mode format (bytes r0, rl, and r2 are 
present). The FCB contains an unambiguous file name which is used in 
the directory scan. Upon return, the random record bytes contain the 
"virtual" file size which is, in effect, the record address of the 
record following the end of the file. if, following a call to 
function 35, the high record byte r2 is 01, then the file contains the 
maximum record count 65536. Otherwise, bytes r0 and rl constitute a 
16-bit value (r0 is the least significant byte, as before) which is 
the file size. 

Data can be appended to the end of an existing file by simply 
calling function 35 to set the random record position to the end of 
file, then performing a sequence of random writes starting at the 
preset record address. 

The virtual size of a file corresponds to the physical size when 
the file is written sequentially. If, instead, the file was created 
in random mode and "holes" exist in the allocation, then the file may 
in fact contain fewer records than the size indicates. If, for 
example, only the last record of an eight megabyte file is written in 
random mode (i.e., record number 65535), then the virtual size is 
65536 records, although only one block of data is actually allocated. 
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*************************************** 

* * 

* FUNCTION 36: SET RANDOM RECORD * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 24H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Random Record Field Set * 
*************************************** 



The Set Random Record function causes the BDOS to automatically 
produce the random record position from a file which has been read or 
written sequentially to a particular point. The function can be 
useful in two ways. 

First, it is often necessary to initially read and scan a 
sequential file to extract the positions of various "key" fields. As 
each key is encountered, function 36 is called to compute the random 
record position for the data corresponding to this key. If the data 
unit size is 128 bytes, the resulting record position is placed into a 
table with the key for later retrieval. After scanning the entire 
file and tabularizing the keys and their record numbers, you can move 
instantly to a particular keyed record by performing a random read 
using the corresponding random record number which was saved earlier. 
The scheme is easily generalized when variable record lengths are 
involved since the program need only store the buffer-relative byte 
position along with the key and record number in order to find the 
exact starting position of the keyed data at a later time. 

A second use of function 36 occurs when switching from a 
sequential read or write over to random read or write. A file is 
sequentially accessed to a particular point in the file, function 36 
is called which sets th6 record number, and subsequent random read and 
write operations continue from the selected point in the file. 
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3. A SAMPLE FILE-TO-FILE COPY PROGRAM. 

The program shown below provides a relatively simple example of 
file operations. The program source file is created as COPY. ASM using 
the CP/M ED program and then assembled using ASM or MAC, resulting in 
a "HEX" file. The LOAD program is the used to produce a COPY.COM file 
which executes directly under the CCP. The program begins by setting 
the stack pointer to a local area, and then proceeds to move the 
second name from the default area at 006CH to a 33-byte file control 
block called DFCB. The DFCB is then prepared for file operations by 
clearing the current record field. At this point, the source and 
destination FCB's are ready for processing since the SFCB at 005CH is 
properly set-up by the CCP upon entry to the COPY program. That is, 
the first name is placed into the default fcb, with the proper fields 
zeroed, including the current record field at 007CH. The program 
continues by opening the source file, deleting any exising destination 
file, and then creating the destination file. If all this is 
successful, the program loops at the label COPY until each record has 
been read from the source file and placed into the destination file. 
Upon completion of the data transfer, the destination file is closed 
and the program returns to the CCP command level by jumping to BOOT. 



0000 


= 


boot 


equ 


00h 


0005 


= 


bdos 


equ 


0005h 


5c 


= 


fcbl 


equ 


005ch 


5c 


= 


sfcb 


equ 


fcbl 


06c 


= 


fcb2 


equ 


006ch 


0080 


= 


dbuff 


equ 


0080h 


0100 


= 


tpa 


equ 


0100h 


0009 


= 


r 

pr intf 


equ 


9 


000f 


= 


openf 


equ 


15 


0010 


= 


closef 


equ 


16 


0013 


= 


deletef 


equ 


19 


0014 


= 


readf 


equ 


20 


0015 


= 


wr itef 


equ 


21 


0016 


= 


makef 


equ 


22 



0100 

0100 311b02 



0103 0el0 



sample file-to-file copy program 

at the ccp level, the command 

copy a:x.y b:u.v 

copies the file named x.y from drive 
a to a file named u.v on drive b. 



system reboot 
bdos entry point 
first file name 
source fcb 
second file name 
default buffer 
beginning of tpa 

print buffer func# 
open file func# 
close file func# 
delete file func# 
sequential read 
sequential write 
make file func# 



tpa ; beginning of tpa 
sp, stack; local stack 

second file name to dfcb 
c,16 ; half an fcb 



org 
lxi 

move 
mvi 
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0105 


116c00 




lxi 


d,fcb2 ; 


source of move 


0108 


21da01 




lxi 


h,dfcb ; 


destination fcb 


010b 


la 


mfcb: 


ldax 


d ; 


source fcb 


010c 


13 




inx 


d ; 


ready next 


010d 


77 




mov 


m,a ; 


dest fcb 


010e 


23 




inx 


h ; 


ready next 


010f 


0d 




dcr 


c ; 


count 16. . .0 


0110 


c20b01 




jnz 


mfcb ; 


loop 16 times 






} 

• 


name has been moved, zero cr 


0113 


af 




xra 


a i 


; a = 00h 


0114 


32fa01 




sta 


df cbcr 


f current rec = 








source 


and destination fcb's ready 


0117 


115C00 




lxi 


d,sfcb , 


i source file 


011a 


cd6901 




call 


open 


? error if 255 


01 Id 


118701 




lxi 


d,nof ile 


? ready message 


0120 


3c 




inr 


a 


; 255 becomes 


0121 


cc6101 


• 


cz 


finis 


r done if no file 






i 


source 


file open, 


, prep destination 


0124 


llda01 




lxi 


d,dfcb 


? destination 


0127 


cd7301 




call 


delete 


; remove if present 


012a 


llda01 


7 


lxi 


d,dfcb 


; destination 


012d 


cd8201 




call 


make 


; create the file 


0130 


119601 




lxi 


d ,nodir 


; ready message 


0133 


3c 




inr 


a 


? 255 becomes 


0134 


cc6101 




cz 


finis 


; done if no dir space 



0137 


115C00 


c 


opy: 


lxi 


d,sfcb 


013a 


cd7801 






call 


read 


013d 


b7 






ora 


a 


013e 


C25101 






jnz 


eof ile 






• 




not end 


of file, 


0141 


llda01 






lxi 


d,dfcb 


0144 


cd7d01 






call 


wr ite 


0147 


lla901 






lxi 


d, space 


014a 


b7 






ora 


a 


014b 


C46101 






cnz 


finis 


014e 


C33701 


• 




jmp 


copy 






i 

e 


of ile: 


; end o 


f file, c 


0151 


llda01 






lxi 


d,dfcb 


0154 


cd6e01 






call 


close 


0157 


21bb01 






lxi 


h,wrprot 


015a 


3c 






inr 


a 


015b 


cc6101 






cz 


finis 



source file open, dest file open 
copy until end of file on source 



source 

read next record 

end of file? 
skip write if so 

write the record 
destination 
write record 
ready message 
00 if write ok 
end if so 
loop until eof 



destination 
255 if error 
ready message 
255 becomes 00 
shouldn't happen 



copy operation complete, end 
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015e llcc01 



lxi 



d, normal; ready message 



0161 0e09 
0163 cd0500 
0166 c30000 



0169 0e0f open: 
016b C30500 

9 

016e 0el0 close: 

0170 C30500 

0173 0el3 delete: 
0175 C30500 

0178 0el4 read: 
017a C30500 

017d 0el5 write: 
017f C30500 



0182 0el6 
0184 C30500 



0187 6e6f20fnof ile: 
0196 6e6f209nodir: 
01a9 6f7574fspace: 
01bb 7772695wrprot: 
01cc 636f 700normal: 



finis: ; write message given by de, reboot 

mvi c,pr intf 

call bdos ; write message 

jmp boot ; reboot system 

system interface subroutines 

(all return directly from bdos) 

mvi c,openf 

jmp bdos 

mvi c,closef 

jmp bdos 

mvi cdeletef 

jmp bdos 

mvi c,readf 

jmp bdos 

mvi c,writef 

jmp bdos 

make: mvi c,makef 

jmp bdos 

; console messages 

db 'no source file$' 

db 'no directory space$ ' 

db •out of data space$' 

db 'write protected?$' 

db 'copy complete? ' 



01da 
01fa = 

01fb 

021b 



dfcb: 
dfcbcr 



stack: 



data areas 
ds 33 
equ dfcb+32 



ds 
end 



32 



; destination fcb 
; current record 

; 16 level stack 



Note that there are several simplifications in this particular 
program. First, there are no checks for invalid file names which 
could, for example, contain ambiguous references. This situation 
could be detected by scanning the 32 byte default area starting at 
location 005CH for ASCII question marks. A check should also be made 




names are different. A speed improvement could be made by buffering 
"re data on each read operation. One could, for example, determine 



mo 
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the size of memory by fetching FBASE from location 0006H and use the 
entire remaining portion of memory for a data buffer. In this case, 
the programmer simply resets the DMA address to the next successive 
128 byte area before each read. Upon writing to the destination file, 
the DMA address is reset to the beginning of the buffer and 
incremented by 128 bytes to the end as each record is transferred to 
the destination file. 
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4. A SAMPLE FILE DUMP UTILITY. 



The file dump program shown below is slightly more complex than 
the simple copy program given in the previous section. The dump 
program reads an input file, specified in the CCP command line, and 
displays the content of each record in hexadecimal format at the 
console. Note that the dump program saves the CCP's stack upon entry, 
resets the stack to a local area, and restores the CCP's stack before 
returning directly to the CCP. Thus, the dump program does not 
perform and warm start at the end of processing. 



0100 
0005 = 

0001 = 

0002 = 
0009 = 

00b = 

000f = 

0014 = 

05c = 

0080 = 



00d = 
00a = 



005c 
05d 
0065 
0068 
06b 

007c 
007d 



0100 210000 

0103 39 

0104 221502 
0107 315702 

010a cdcl01 
010d feff 
010f c21b01 



0112 llf301 
0115 cd9c01 
0118 C35101 





org 


bdos 


egu 


cons 


equ 


typef 


egu 


pr mtf 


equ 


brkf 


equ 


openf 


equ 


readf 


equ 


fcb 


equ 


buff 


equ 


• 

r 


non 


cr 


equ 



DUMP program reads input file and displays hex data 



100h 

0005h ;dos entry point 

1 ;read console 

2 ; type function 

9 ;buffer print entry 

11 ;break key function (true if char 

15 ;file open 

20 ; read function 

5ch ;file control block address 

80h ;input disk buffer address 



graphic characters 

0dh ;carriage return 
egu 0ah ;line feed 

file control block definitions 

egu fcb+0 ;disk name 

egu fcb+1 ;file name 

egu fcb+9 ;disk file type (3 characters) 

egu fcb+12 ;file's current reel number 

egu fcb+15 ;file's record count (0 to 128) 

egu fcb+3 2 ; cur rent (next) record number (0 

egu fcb+33 ;fcb length 

set up stack 

lxi h,0 

dad sp 

entry stack pointer in hi from the ccp 

shld oldsp 

set sp to local stack area (restored at finis) 

lxi sp,stktop 

read and print successive buffers 

call setup ;set up input file 

cpi 255 ;255 if file not present 

jnz openok ;skip if open is ok 

file not there, give error message and return 

lxi d, opnmsg 

call err 

jmp finis ;to return 



If 



fcbdn 
fcbfn 
fcbft 
fcbrl 
fcbrc 
fcbcr 
fcbln 
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011b 3e80 
011d 321302 

0120 210000 



open ok: 



;open operation ok, set buffer index to end 

mvi a,80h 

sta ibp ;set buffer pointer to 80h 

hi contains next address to print 

lxi h,0 ;start with 0000 



0123 e5 

0124 cda201 

0127 el 

0128 da5101 
012b 47 



012c 7d 
012d e60f 
012f C24401 

0132 cd7201 



0135 cd5901 



gloop: 



push 
call 
pop 

jc 
mov 



;save line position 



jrecall line position 

;carry set by gnb if end file 



0138 


0f 


rrc 




0139 


da5101 


jc 


finis 


013c 


7c 


mov 


a,h 


013d 


cd8f01 


call 


phex 


0140 


7d 


mov 


a,l 


0141 


cd8f01 

nonum: 


call 


phex 


0144 


23 


inx 


h 


0145 


3e20 


mvi 


a, 1 ' 


0147 


cd6501 


call 


pchar 


014a 


78 


mov 


a,b 


014b 


cd8f01 


call 


phex 


014e 


C32301 


jmp 


gloop 



h 

gnb 

h 

finis 

b,a 

print hex values 
check for line fold 
mov a , 1 

ani 0fh ;check low 4 bits 
jnz nonum 
print line number 
call crlf 

check for break key 

call break 

accum lsb = 1 if character ready 

;into carry 

;don't print any more 



;to next line number 



finis: 



0151 cd7201 
0154 2al502 

0157 f9 

0158 c9 



end of dump, return to ccp 

(note that a jmp to 0000h reboots) 

call crlf 

lhld oldsp 

sphl 

stack pointer contains ccp's stack location 

ret ;to the ccp 



subroutines 



0159 e5d5c5 

015c 0e0b 

015e cd0500 

0161 cldlel 



break: ;check break key (actually any key will do) 
push h! push d! push b; environment saved 
mvi c,brkf 
call bdos 
pop b! pop d! pop h; environment restored 



(All Information Contained Herein is Proprietary to Digital Research.) 

35 



0164 c9 



ret 



pchar: ;print a character 

0165 e5d5c5 push h! push d! push b; saved 

0168 0e02 mvi c,typef 

016a 5f mov e,a 

016b cd0500 call bdos 

016e cldlel pop b! pop d! pop h; restored 

0171 c9 ret 



crlf: 



0172 
0174 
0177 
0179 
017c 



3e0d 

cd6501 

3e0a 

cd6501 

c9 



mvi 

call 

mvi 

call 

ret 



a, cr 
pchar 
a, If 
pchar 



pnib: 



017d 


e60f 




017f 


fe0a 




0181 


d28901 




0184 


c630 


f 


0186 


c38b01 


m 
9 


0189 


c637 


• 

pl0 


018b 


cd6501 


prn 


018e 


c9 


• 

phe 


018f 


f5 




0190 


0f 




0191 


0f 




0192 


0f 




0193 


0f 




0194 


Cd7d01 




0197 


fl 




0198 


Cd7d01 




019b 


c9 





;print nibble in reg 

; low 



am 

cpi 

jnc 

less 

adi 

jmp 



0fh 
10 
pl0 
than or equal to 
'0' 
prn 



bits 



greater or equal to 10 

adi 'a' - 10 

call pchar 
ret 

;print hex char in reg a 



push 

rrc 

rrc 

rrc 

rrc 

call 

pop 

call 

ret 



psw 



pnib 

psw 
pnib 



;print nibble 



019c 0e09 
019e cd0500 
01al c9 



err: ;print error message 

; d,e addresses message ending with "§'' 

mvi cprintf ;print buffer 

call bdos 

ret 



function 



01a2 3al302 
01a5 fe80 
01a7 c2b301 



gnb: 



;get 


next byte 


Ida 


ibp 


cpi 


8 0h 


]nz 


g0 


read 


another buffer 
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01a a cdce01 
01ad b7 
01ae cab301 

01bl 3 7 
01b2 c9 



01b3 5f 

01b4 1600 

01b6 3c 

01b7 321302 



01ba 218000 
01bd 19 

01be 7e 

01bf b7 
01c0 c9 



01cl af 
01c2 327c00 

01c5 115C00 
01c8 0e0f 
01ca cd0500 

01cd c9 



01ce e5d5c5 
01dl 115C0 
01d4 0el4 
01d6 cd0500 
01d9 cldlel 
01dc c9 



g0 



setup: 

■ 



diskr 



call 
ora 

jz 
end 
stc 
ret 



diskr 

a ;zero value if read ok 
g0 ;for another byte 
of data, return with carry set for eof 



;read the byte at buff+reg a 

mov e,a ;ls byte of buffer index 

mvi d,0 ;double precision index to de 

inr a ; index=index+l 

sta ibp ;back to memory 

pointer is incremented 

save the current file address 

lxi h,buff 

dad d 

absolute character address is in hi 

mov a,m 

byte is in the accumulator 

ora a ;reset carry bit 

ret 

;set up file 

open the file for input 

xra a ;zero to accum 

sta fcbcr ;clear current record 

lxi d,fcb 

mvi c,openf 

call bdos 

255 in accum if open error 

ret 

;read disk file record 

push h! push d! push b 

lxi d,fcb 

mvi c,readf 

call bdos 

pop bl pop d! pop h 

ret 



; fixed message area 
01dd 46494c0signon: db 'file dump version 2.0$' 
01f3 0d0a4e0opnmsg: db cr,lf,'no input file present on disk$' 



0213 
0215 



0217 
0257 



; variable area 

ibp: ds 2 ; input buffer pointer 

oldsp: ds 2 ;entry sp value from ccp 

• 

; stack area 

ds 64 ; reserve 32 level stack 
stktop: 

r 

end 
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5. A SAMPLE RANDOM ACCESS PROGRAM. 

This manual is concluded with a rather extensive, but complete 
example of random access operation. The program listed below performs 
the simple function of reading or writing random records upon command 
from the terminal. Given that the program has been created, 
assembled, and placed into a file labelled RANDQM.COM, the CCP level 
command : 

RANDOM X.DAT 

starts the test program. The program looks for a file by the name 
X.DAT (in this particular case) and, if found, proceeds to prompt the 
console for input. If not found, the file is created before the 
prompt is given. Each prompt takes the form 

next command? 

and is followed by operator input, terminated by a carriage return. 
The input commands take the form 

nW nR Q 

where n is an integer value in the range to 65535, and W, R, and Q 
are simple command characters corresponding to random write, random 
read, and quit processing, respectively. If the W command is issued, 
the RANDOM program issues the prompt 

type data: 

The operator then responds by typing up to 127 characters, followed by 
a carriage return. RANDOM then writes the character string into the 
X.DAT file at record n. If the R command is issued, RANDOM reads 
record number n and displays the string value at the console. If the 
Q command is issued, the X.DAT file is closed, and the program returns 
to the console command processor. In the interest of brevity, the 
only error message is 

error, try again 

The program begins with an initialization section where the 
input file is opened or created, followed by a continuous loop at the 
label "ready 11 where the individual commands are interpreted. The 
default file control block at 005CH and the default buffer at 0080H 
are used in all disk operations. The utility subroutines then follow, 
which contain the principal input line processor, called "readc." 
This particular program shows the elements of random access 

processing, and can be used as the basis for further program 
development. 
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0100 
0000 

0005 

0001 
0002 
0009 
000a 
000c 
000f 
0010 
0016 
0021 
0022 

5c 
007d 
007f 
0080 

000d 
000a 



• ********************** 

• * 


;* sample ra 
• * 


ndom access 


• ********************** 




org 


100h 


9 

reboot 


equ 


00 00h 


bdos 


equ 


0005h 


f 

coninp 


equ 


1 


conout 


equ 


2 


pstring 


equ 


9 


rstring 


equ 


10 


version 


equ 


12 


openf 


equ 


15 


closef 


equ 


16 


makef 


equ 


22 


readr 


equ 


33 


writer 


equ 


34 


fcb 


equ 


005ch 


ranrec 


equ 


fcb+3 3 


ranovf 


equ 


fcb+35 


buff 


equ 


0080h 


cr 


equ 


0dh 


If 


equ 


0ah 



***************************** 

* 

* 
* 

***************************** 
;base of tpa 



program for cp/m 2.0 



0100 31bc0 



0103 0e0c 

0105 cd050 

0108 fe20 

010a d2160 

010d lllbB 
0110 cdda0 
0113 C3000 



0116 0e0f 

0118 115c0 

011b cd050 

011e 3c 

011f C2370 



; system reboot 
;bdos entry point 

;console input function 
;console output function 
;print string until '$' 
; read console buffer 
;return version number 
;file open function 
;close function 
;make file function 
;read random 
;write random 

;default file control block 
;random record position 
;high order (overflow) byte 
;buf f er address 

; carriage return 
;line feed 



*************************************************** 

* * 

* load SP, set-up file for random access * 

* * 
*************************************************** 

lxi sp, stack 

version 2.0? 

mvi c, version 

call bdos 

cpi 20h yversion 2.0 or better? 

jnc versok 

bad version, message and go back 

lxi d ,badver 

call print 

jmp reboot 



versok : 



correct version for random access 

mvi c, openf ;open default fcb 

lxi d,fcb 

call bdos 

inr a ;err 255 becomes zero 

jnz ready 

cannot open file, so create it 
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0122 0el6 


mvi 


c f makef 




0124 115c0 


lxi 


d,fcb 




0127 cd050 


call 


bdos 




012a 3c 


inr 


a 


;err 255 becomes zero 


012b C2370 


jnz 


ready 





012e 113a0 
0131 cdda0 
0134 C3000 



0137 cde50 
013a 227d0 
013d 217f0 
0140 3600 
0142 fe51 
0144 C2560 



0147 0el0 

0149 115c0 
014c cd050 
014f 3c 

0150 cab90 
0153 C3000 



cannot create file, directory full 

lxi d,nospace 

call print 

jmp reboot ;back to ccp 

*************************************************** 

* * 

* loop back to "ready" after each command * 

* * 
*************************************************** 

ready: 

file is ready for processing 

call readcom ;read next command 

shld ranrec ;store input record# 

lxi h, ranovf 

mvi m,0 ;clear high byte if set 

cpi 'Q' ;quit? 

jnz notq 

; quit processing, close file 

mvi c,closef 

lxi d,fcb 

call bdos 

inr a ;err 255 becomes 

jz error ;error message, retry 

jmp reboot ;back to ccp 

**************************************************** 
. * * 

r 

;* end of quit command, process write * 

. * * 

.*************************************************** 



notq: 



0156 fe57 
0158 C2890 



015b 114d0 
015e cdda0 
0161 0e7f 
0163 21800 

0166 c5 

0167 e5 

0168 cdc20 
016b el 



not the quit command, random write? 

cpi 

jnz 



notw 



rloop: 



this is a random write, fill buffer until cr 

lxi d,datmsg 

call print ;data prompt 

mvi c,127 ;up to 127 characters 

lxi h,buff destination 

;read next character to buff 

push b ;save counter 

push h ;next destination 

call getchr ;character to a 

pop h ;restore counter 
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016c 


cl 


016d 


fe0d 


016f 


ca780 


0172 


77 


0173 


23 


0174 


0d 


0175 


C2660 



erloop: 



0178 3600 



017a 
017c 
017f 
0182 
0183 
0186 



0e22 

115c0 

cd050 

b7 

c2b90 

C3370 



0189 


fe52 


018b 


c2b90 


018e 


0e21 


0190 


115c0 


0193 


cd050 


0196 


b7 


0197 


c2b90 


019a 


cdcf0 


019d 


0e80 


019f 


21800 


01a2 


7e 


01a3 


23 


01a4 


e67f 


01a 6 


ca370 


01a9 


c5 


01a a 


e5 


01ab 


fe20 


01ad 


d4c80 


01b0 


el 


01bl 


cl 


01b2 


0d 


01b3 


c2a20 


01b6 


C3370 



pop b ;restore next to fill 

cpi cr ;end of line? 

jz erloop 

not end, store character 

mov m,a 

inx h ;next to fill 

dcr c ;counter goes down 

jnz rloop ;end of buffer? 

end of read loop, store 00 
mvi m,0 

; write the record to selected record number 

mvi c,wr iter 

Ixi d,fcb 

call bdos 

ora a ;error code zero? 

jnz error ;message if not 

jmp ready ;for another record 

r 

**************************************************** 

. * * 

r 

* 



;* end of write command, process read 
• * 



**************************************************** 

notw: 

; not a write command, read record? 

cpi 'R' 

jnz error ;skip if not 

; read random record 

mvi c,readr 

lxi d,fcb 

call bdos 

ora a ;return code 00? 

jnz error 

; read was successful, write to console 

call crlf ;new line 

mvi c,128 ;max 128 characters 

lxi h f buff ;next to get 



wloop: 



mov 
inx 
ani 

jz 
push 

push 

cpi 

cnc 

pop 

pop 

dcr 

jnz 

jmp 



;next character 

;next to get 

;mask parity 

;for another command if 00 

;save counter 

;save next to get 

;graphic? 
putchr ;skip output if not 
h 
b 
c 

wloop 
ready 



a,m 

h 

7fh 

ready 

b 

h 



;count=count-l 
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01b9 11590 

01bc cdda0 
01bf C3370 



01c2 0e01 
01c4 cd050 
01c7 c9 



*************************************************** 

* * 

* end of read command, all errors end-up here * 

* * 

*************************************************** 



error: 

lxi d,errmsg 

call print 

jmp ready 

*************************************************** 

* * 

* utility subroutines for console i/o * 

* * 
*************************************************** 

getchr : 

;read next console character to a 
mvi c,coninp 
call bdos 
ret 



putchr : 



01c8 0e02 

01ca 5f 

01cb cd050 

01ce c9 



;write character from a to console 

mvi c, conout 

mov e r a ;character to send 

call bdos ;send character 

ret 



crlf 



01cf 3e0d 

01dl cdc80 

01d4 3e0a 

01d6 cdc80 

01d9 c9 



;send carriage return line feed 

mvi a,cr ;carriage return 

call putchr 

mvi a, If ?line feed 

call putchr 

ret 



print: 



01da d5 
01db cdcf0 
01de dl 
01df 0e09 
01el cd050 
01e4 c9 



;print the buffer addressed by de until $ 

push d 

call crlf 

pop d ;new line 

mvi c / pstring 

call bdos ;print the string 

ret 



readcom: 



01e5 116b0 
01e8 cdda0 
01eb 0e0a 
01ed 117a0 
01f0 cd050 



;read the next command line to the conbuf 

lxi d, prompt 

call print ;command? 

mvi c, r string 

lxi d f conbuf 

call bdos ;read command line 

command line is present, scan it 
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01f3 
01f6 
01f9 
01fa 
01fb 
01fc 

01fd 
01ff 
0201 

0204 
0205 
0206 
0207 
0208 
0209 
020a 
20b 
020c 
20f 
0210 



0213 
0215 
0217 

0218 
21a 



21000 

117c0 

la 

13 

b7 

c8 

(3630 
fe0a 
d2130 

29 

4d 

44 

29 

29 

09 

85 

6f 

d2f90 

24 

c3f90 



c630 
fe61 
d8 

e65f 
c9 



lxi 
lxi 
readc: ldax 
inx 



endrd: 



h,0 ;start with 0000 
d,conlin;command line 
d ;next command character 
d ; to next command position 
a ;cannot be end of command 



ora 
rz 

not zero, numeric? 

sui , I 

cpi 10 ;carry if numeric 

jnc endrd 

add-in next digit 

dad h ;*2 

c,l 

;bc = value * 2 

;*4 

;*8 

;*2 + *8 = *10 
;+digit 



mov 
mov 
dad 
dad 
dad 
add 
mov 
jnc 
inr 
jmp 



b,h 

h 

h 

b 

1 

l,a 

readc 

h 

readc 



;for another char 

; overflow 

;for another char 



end of read, restore value in a 

adi ' 1 ; command 

cpi 'a 1 ;translate case? 

re 

lower case, mask lower case bits 

ani 101$llllb 

ret 



021b 
23a 
024d 
0259 
026b 



************************************************ 
* * 

* 
* 
*************************************************** 

badver : 

•sorry, you need cp/m version 2$' 



* string data area for console messages 
* 



536f79 db 

nospace: 
4e6f29 db 

datmsg : 
547970 db 

errmsg : 
457272 db 

prompt: 
4e6570 db 



'no directory space$ ' 
1 type data: $ ' 
'error, try again. $' 
'next command? $' 
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027a 21 
027b 
027c 
0021 = 

029c 
2bc 



*************************************************** 

* * 

* fixed and variable data area * 

* * 

*************************************************** 
conbuf: db conlen ;length of console buffer 

1 ;resulting size after read 
32 ;length 32 buffer 
$-consiz 



consiz: ds 
conlin: ds 
conlen equ 



stack: 



ds 



end 



32 



;16 level stack 



Again, major improvements could be made to this particular 
program to enhance its operation. In fact, with some work, this 
program could evolve into a simple data base management system. One 
could, for example, assume a standard record size of 128 bytes, 
consisting of arbitrary fields within the record. A program, called 
GETKEY, could be developed which first reads a sequential file and 
extracts a specific field defined by the operator. For example, the 
command 

GETKEY NAMES.DAT LASTNAME 10 20 

would cause GETKEY to read the data base file NAMES.DAT and extract 
the "LASTNAME 11 field from each record, starting at position 10 and 
ending at character 20. GETKEY builds a table in memory consisting of 
each particular LASTNAME field, along with its 16-bit record number 
location within the file. The GETKEY program then sorts this list, 
and writes a new file, called LASTNAME. KEY, which is an alphabetical 
list of LASTNAME fields with their corresponding record numbers. 
(This list is called an "inverted index" in information retrieval 

parlance. ) 

Rename the program shown above as QUERY, and massage it a bit so 
that it reads a sorted key file into memory. The command line might 
appear as: 

QUERY NAMES.DAT LASTNAME. KEY 

Instead of reading a number, the QUERY program reads an alphanumeric 
string which is a particular key to find in the NAMES.DAT data base. 
Since the LASTNAME. KEY list is sorted, you can find a particular entry 
quite rapidly by performing a "binary search," similar to looking up a 
name in the telephone book. That is, starting at both ends of the 
list, you examine the entry halfway in between and, if not matched, 
split either the upper half or the lower half for the next search. 
You'll quickly reach the item you're looking for (in log2(n) steps) 
where you'll find the corresponding record number. Fetch and display 
this record at the console, just as we have done in the program shown 
above. 
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At this point you're just getting started. With a little more 
work, you can allow a fixed grouping size which differs from the 128 
byte record shown above. This is accomplished by keeping track of the 
record number as well as the byte offset within the record. Knowing 
the group size, you randomly access the record containing the proper 
group, offset to the beginning of the group within the record read 
sequentially until the group size has been exhausted. 

Finally, you can improve QUERY considerably by allowing boolean 
expressions which compute the set of records which satisfy several 
relationships, such as a LASTNAME between HARDY and LAUREL, and an AGE 
less than 45. Display all the records which fit this description. 
Finally, if your lists are getting too big to fit into memory, 
randomly access your key files from the disk as well. One note of 
consolation after all this work: if you make it through the project, 
you'll have no more need for this manual! 
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6. SYSTEM FUNCTION SUMMARY. 



FUNC FUNCTION NAME 



INPUT PARAMETERS OUTPUT RESULTS 



System Reset 

1 Console Input 

2 Console Output 

3 Reader Input 

4 Punch Output 

5 List Output 

6 Direct Console I/O 

7 Get I/O Byte 

8 Set I/O Byte 

9 Print String 

10 Read Console Buffer 

11 Get Console Status 

12 Return Version Number 

13 Reset Disk System 

14 Select Disk 

15 Open File 

16 Close File 

17 Search for First 

18 Search for Next 

19 Delete File 

20 Read Sequential 

21 Write Sequential 

22 Make File 

23 Rename File 

24 Return Login Vector 

25 Return Current Disk 

26 Set DMA Address 

27 Get Addr(Alloc) 

28 Write Protect Disk 

29 Get R/O Vector 

30 Set File Attributes 

31 Get Addr(disk parms) 

32 Set/Get User Code 
3 3 Read Random 

34 Write Random 

35 Compute File Size 

36 Set Random Record 



* Note that A = L, and B = 



none 




none 


none 




A = 


char 


E = char 


none 


none 




A = 


char 


E = char 


none 


E = char 


none 


see def 


see 


def 


none 




A = 


IOBYTE 


E = IOBYTE 


none 


DE = 


.Buffer 


none 


DE = 


.Buffer 


see 


def 


none 




A = 


00/FF 


none 




HL= 


Version* 


none 




see 


def 


E = Disk Number 


see 


def 


DE = 


.FCB 


A = 


Dir Code 


DE = 


.FCB 


A = 


Dir Code 


DE = 


.FCB 


A = 


Dir Code 


none 




A = 


Dir Code 


DE = 


.FCB 


A = 


Dir Code 


DE = 


.FCB 


A = 


Err Code 


DE = 


.FCB 


A = 


Err Code 


DE = 


.FCB 


A = 


Dir Code 


DE = 


.FCB 


A = 


Dir Code 


none 




HL= 


Login Vect* 


none 




A = 


Cur Disk# 


DE = 


.DMA 


none 


none 




HL= 


.Alloc 


none 




see 


def 


none 




HL= 


R/O Vect* 


DE = 


.FCB 


see 


def 


none 




HL= 


.DPB 


see d 


ef 


see 


def 


DE = 


.FCB 


A = 


Err Code 


DE = 


.FCB 


A = 


Err Code 


DE = 


.FCB 


r0, 


rl, r2 


DE = 


.FCB 


r0. 


rl, r2 


H upo 


n return 
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7 . ADDENDUM 

NEW CP/M 2.2 
BDOS FUNCTIONS 



JU JU .J. _ i„ ^r. ju ^u ju ju ju ju ju ju ju .a. ju ju fc r, .jr. ^ ju ju JU JU -'- *-' — V -'- *■'■* - 1 - *■'/- *-l- -'- -V - , - 
X yOC^\ X yv yv yv /C yO\ /OOC yv ?v yv y< *Ov /C yC yv yC yv yv yC yv yv yv yC *C yv /C y\ 



* FUNCTION 37: RESET DRIVE 



* 



j,. ju ju ju ju ju ju ju ju »*- -*- -I- *•■» -V -•-* -'- -V -•- - ! - "'- *'- - 1 * -'- -'- -A- -'«- *i*- **'- -i'" -'- *■'- *■*- **- ~ ? - **'r 
7S *\ yv yv yf y\ yv vv yC yv. yv *\ yv yv y\ yv yv /v /v /v y\ /v yv yv ?C yv?\ yv J* yv yv yv /v /v yv 

Vc 

25H * 

Drive Vector * 



Entry Parameters 
Register C 
Register DE 

Returned Value 






* Register A: 00H 

JU JU JU JU JU JU JU JU JU JU JU JU JO JU JU »U J- JU JU JU JU JU -V JU JU JU JU JU JU JU JU JU JU JU JU 
yv yC y v ys yv /v /f yC y\ >C /C y v ?f yv yC yv yv yv yv yv yv ?C /" yv yv yv yv yv yv /C yv yv yv /C yC 



The RESET DRIVE function allows resetting of specified 
drive(s). The passed parameter is a 16 bit vector of drives 
to be reset, the least significant bit is drive A:. 

In order to maintain compatibility with MP/M, CP/M 
returns a zero value. 



JU «. , ( --A» -'- -•- *v f - «•'- *J- -i- ^'^ *»j*^'- ^V- v f - » f - »'- -'- -.'- *'- --'^ fct- -,U -'- v'- ».•- »'- »'- ^'- ~»- ^»- ^1* »'- v»- ..»- 
^C /f y\ /\ /s yv /v /* /V >C /V /\ /C iv /\ y* y^ y\ y\ /C?C7C /\ y\ 7C yC y\ 7C7C vC7C7\ 7C%\ 

* FUNCTION 40: WRITE RANDOM WITH* 

* ZERO FILL * 



».. .a. fcU ^u *.i- *.'- ^u ^»- fc'-» .a. »t^ u *.>, fc i- *.<--'- 

v /^ yv y\ y^ y\ y\ yv y\ /v y\ yv yv a A y* 



^i, J, fc t^ JU ^l^. ..I., ^i^ ^.t^. fc r. ^^ ^.U ^i^. ^i^. j i ^i^ ^t,. ^.t^ ^i^ 
yv /i yv y\ j\ y\ /\ /v yv y\ yv /\ yC /C /v y\ /s y\ 

* Entry Parameters 

* Register C 

* Register DE 

* Returned Value: * 

* Register A: Return Code * 

JU JU -»-. J> Ji- J 1 , J»* JU J- J)- ».T, ^U ^ JU Ji^. Jj^ «!,. ^(^ „t. ^t U J)„ ^F^ ^l, ^l. ^U J- JU J) U ^U JU J- JU 

X/f A /> y\ *v y\ /\ y\ /\ y\ /\7\ yC y\ y\ 7v *\ y\ yv "C yww\ yC n/CX^/s y\ yC^C yC 



28H 

FCB Address * 



The WRITE RANDOM WITH ZERO FILL operation is similar 
to FUNCTION 34: with the exception that a previously 
unallocated block is filled with zeros before the data 
is written. 
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